home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / keyprs30.zip / KEYPRESS.DOC < prev   
Text File  |  1991-03-19  |  6KB  |  128 lines
  1. KeyPress, By Tony McNamara.    Copywrite 1991.
  2. Version 3.0
  3.  
  4. <<<<<<<<<<<<<<<<<<<     LEGAL DISTRIBUTION STUFF     >>>>>>>>>>>>>>>>>>>
  5. This file may be distributed only according to the following conditions:
  6.     1 - This documentation must accompany the file.
  7.     2 - Neither the executable nor the documentation may be modified.
  8.     3 - No charge may be made for this software.  
  9.  
  10.     I am going to spell out Item 3 here, to give my product a slime-resistant
  11. coating.  This program may not be distributed as part of a set with which a
  12. cost is associated.   If this program is distributed on a diskette, no charge
  13. may be made for that diskette.  If this program is distributed as part of a
  14. set of programs on a diskette, no charge may be made for ANY of the programs
  15. on that diskette.  The only person authorized to charge for the program or to
  16. modify the program or the documentation is the program's author.
  17.  
  18.     The one exception to the no charge rule is: on-line services such as
  19. CompuServe and Genie do not have to modify their policies for this software. 
  20. As long as it has been uploaded with this file and the executable, and is
  21. downloaded as a packet too (i.e. in ZIP or similar format), the cost of
  22. connect-time is to be considered not a charge for this software but rather an
  23. opportunity cost similar to that of the long-distance phone call when
  24. ordering a product.
  25.  
  26. <<<<<<<<<<<<<<<<<<<<<<     END of LEGAL STUFF     >>>>>>>>>>>>>>>>>>>>>>
  27.  
  28. KeyPress.COM, By Tony McNamara.
  29.  
  30. Purpose:
  31.     KeyPress is designed to "stuff" the keyboard buffer.  Unlike other
  32. programs, however, KeyPress is not a TSR and does not hook any interrupt
  33. vectors to do this.  The result is that KeyPress does not require any memory
  34. and does not pose a compatibility problem for any other programs.  The
  35. downside is that KeyPress can only stuff in 16 characters before running out
  36. of space in the keyboard buffer.
  37.  
  38. Usage:
  39.     KeyPress should be used from a batch file or script such as those in the
  40. Norton Commander User Menu section.  This is because KeyPress doesn't waste
  41. any time stuffing the keyboard buffer, so you can't have the stuffings saved
  42. if you use it at the DOS prompt - DOS would read the buffer itself were it
  43. not already reading from a batch or script file.
  44.  
  45.  
  46. Parameters:
  47.     <string>    :   ASCII to stuff into the keyboard buffer
  48.     //          :   Stuff a "/" (slash) to the buffer.  This is needed   
  49.                     because "/" is used to delimit special codes.
  50.     /E          :   Stuff an <Escape>.                                
  51.     /R          :   Stuff <Enter>.                                         
  52.     /F#         :   Stuff Function-Key #.
  53.     /S#         :   Stuff Shifted-Function-Key #.
  54.     /A#         :   Stuff Alt-Function-Key #.
  55.     /C#         :   Stuff Control-Function-Key #.
  56.     /Cx         :   Stuff Control-x.
  57.     /N###       :   Stuff ASCII character ### (000-255, all 3 digits needed.) 
  58.     /Kx         :   Stuff a Kursor Keypad character (0-9, or .+-*/)
  59.     /?          :   Command summary - for quick usage reminders.
  60.  
  61. ----------------------------------------------------------------------------
  62.     Function Key Numbers:
  63.         For parameters denoted with "#", # is a single digit.  F10 is
  64.     represented by "0".  F11 and F12 are not supported.
  65.  
  66.     Control Characters:
  67.         Control characters generally can not be entered at the DOS
  68.     prompt, because they are acted upon.  This allows those characters to
  69.     be stuffed anyhow.  This is not the place for a full  explanation of
  70.     their functions, but I'll list a few below.  These are the characters
  71.     from 1 to 1Ah or 26d, known also as "Control-A" to "Control-Z", and 
  72.     written as ^A to ^Z.
  73.  
  74.     Note: The following are not the keys they look like.  For example, 
  75.           ^H is not the <BackSpace> key.  Rather, it is the ASCII 
  76.           representation of that function.  Some programs may follow the
  77.           ASCII code, some may not.  Terminal emulators generally will.
  78.  
  79.         ^G, 07h, is the Bell
  80.         ^H, 08h, is "backspace".  
  81.         ^I, 09h, is TAB         
  82.         ^L, 0Ch, is Form Feed.  This usually ejects a page from the printer.
  83.         ^M, 0Dh, is "Carriage Return".  Use /E instead whenever possible
  84.                     because /E puts in the whole scan code, not just ASCII.
  85.         ^Z, 1Ah, is <End-Of-File> and "Substitute".  
  86.  
  87.  
  88.     ASCII Characters (/Nxxx):
  89.         The /N parameter is to allow you easier access to non-printable
  90.     characters, but work the same as the Control Characters.  For example,
  91.     /Ca and /N001 would stuff the same value, and so would /Cz and /N026.
  92.  
  93.     Kursor Keypad Characters (/Kx):
  94.         The /K parameter stuffs the cursor control keys found on the 
  95.     numeric keypad.  It does this in 101-key mode.  (i.e. 00, not E0)
  96.     The values stuffed are the extended scan codes for the keys, not
  97.     their ASCII values (although I stuff the ASCII value if the key 
  98.     always produces one).  The result is that /K8 stuffs the equivelent
  99.     of hitting the up-arrow key, /K. hits <Delete>, and /K1 is the
  100.     <End> key.  The grey keys (numeric +, -, *, and /) are duplicated 
  101.     because these keys have special functions in some programs, such as
  102.     The Norton Commander and Brief.
  103.   
  104. ----------------------------------------------------------------------------
  105. Examples:
  106.     If you had a mail program you wanted to automate, which required your
  107. password before it would let you into the program, and then required <F10>
  108. to pull down the menu and the down arrow twice plus <Enter> to Receive your 
  109. messages, you could automate this with the following batch file:
  110.         KeyPress password/r/f0/k2/k2/r
  111.         mail_prg
  112.     
  113.  
  114.  
  115. ----------------------------------------------------------------------------
  116. Contacting the author:
  117.         
  118.         If you have problems or suggested enhancements, or just are 
  119. feeling generous and wish to send me a gratuity <grin>, you can reach
  120. me at:
  121.                 CompuServe: 72477,2504
  122.                 MCI Mail:   381-9188    -  TMCNAMARA
  123.  
  124.                         <END>
  125.  
  126.            
  127.  
  128.